home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 28 / Mac Magazin and MacEasy Magazine CD - Issue 28.iso / Online / BulkRate 2.5.1 / BulkRate help < prev    next >
Text File  |  1996-10-24  |  69KB  |  923 lines

  1. BulkRate incoming mailbox
  2. *BulkRate Help         Introduction                                  About BulkRate
  3.  
  4. 1744
  5. INTRODUCTION
  6.  
  7. BulkRate is an offline reader for FirstClass® BBSs.  Using BulkRate, you can quickly capture all new mail and messages, then read and reply to them while "offline," or no longer connected to the BBS.  This minimizes the amount of time you spend online, which has two benefits:  One, if the BBS you call is a toll call for you, you save money.  Two, if the BBS is a busy one, the line is freed up for another's use more quickly.
  8.  
  9. BulkRate works only with FirstClass® BBSs. You must have an active account on a FirstClass® BBS before using BulkRate with that BBS. 
  10.  
  11. BulkRate connects to the FirstClass® BBS via FirstClass's CLUI (Command Line User Interface).  Not all FirstClass® BBSs support this, though most do.  If yours doesn't, you cannot use BulkRate with it.
  12.  
  13. Unlike some offline readers for use with other BBS systems, BulkRate does not compress messages and mail or employ error checking, so it is subject to line noise and random errors.  If, however, you have a relatively clean phone line and/or a modem that supports data compression and error correction, this should not present much of a problem.
  14.  
  15. BulkRate is © 1991-1996 by Greg Neagle.  Versions prior to 2.0 were free (I asked users to send me a postcard).  They still are, but I have discontinued all support for versions prior to 2.0.  Versions 2.0-2.5 and any subsequent versions of BulkRate are SHAREWARE.  I ask $25 US for a single user license.
  16.  
  17. See the Registering BulkRate chapter for more options and details.
  18.  
  19. BulkRate 2.5 was created using Staz Software's FutureBasic II and Program Generator.  FutureBasic II is a BASIC compiler for the Macintosh, and Program Generator is a interface designer/application framework/function library rolled into one.
  20.  
  21.  
  22. *BulkRate Help         Introduction                                 Getting started
  23.  
  24. 2123
  25. GETTING STARTED
  26.  
  27. 1)  Log on to your FirstClass® BBS using FirstClass® Client.  When the Desktop window opens, choose "New folder" from the Conference menu. A new folder should appear on your (FirstClass®) Desktop.  Select the folder and choose "Get Info..." from the File menu.  In the Get Info dialog, change the folder's name to "BulkRateToRead" -- make sure there are NO spaces in this name.  If you want to use a different name, make sure it has no spaces in it, and be sure to enter this name under "Exchange settings" in BulkRate.
  28.  
  29. Now, go find the conferences you are interested in having BulkRate read for you.  Select them, then choose "Make alias" from the Conference menu. (These FirstClass® aliases have nothing to do with System 7 file aliases.) This will create aliases of the selected conferences on the FirstClass® Desktop. (You cannot and need not alias your Mailbox.) Once you have aliased all the desired conferences (make sure you get any wanted sub-conferences that reside inside other conferences), return to the FirstClass® Desktop.
  30.  
  31. To finish, drag all the aliased conferences into your new BulkRateToRead folder.  Make sure to scroll around the FirstClass® Desktop to be sure you have moved all the aliases.  You can then log off the BBS.
  32.  
  33. 2)  Launch BulkRate by double-clicking on its icon.  After the splash screen goes away, you'll see a standard files dialog.  If you have used an older version of BulkRate, select a BulkRate 1.x settings file (now called a "Service file") via this dialog.  Otherwise, you may select a FirstClass® settings file.
  34.  
  35. BulkRate will convert the settings files to its own format.  You'll see a window that shows the name of the BBS, your UserID, your password (in bullets), and the phone number or numbers of the BBS.
  36.  
  37. When BulkRate converts a FirstClass® settings file, it converts only UserID, Password, and the phone number.  It does not convert any modem information  for two reasons: one, all the information is not stored in the settings file; and two, correct modem settings for FirstClass® Client are not necessarily the correct modem settings for BulkRate.
  38.  
  39.  
  40. *BulkRate Help         Introduction                                 Reading your mail
  41.  
  42. 803
  43. READING YOUR MAIL
  44.  
  45. Reading your mail is simple.  Click the "Incoming mail" icon in the Service window or choose "Incoming mail" from the View menu.  A window will open, listing all the messages in that mailbox.  Unread messages are flagged, just like in FirstClass® Client.  You may sort this list using the View menu.  Double-click on a message to open it for reading.
  46.  
  47. Once you've read a message, you have several options.  You may close it and choose another from the list.  You may choose "Next unread" or "Next in thread" from the Mail menu.  You may click any of several buttons on the Palette. (See the section on the Palette for a complete description of your options here.) Finally, you can simply advance to the next message by hitting the return key, the enter key, or the right arrow key.  
  48.  
  49.  
  50. *BulkRate Help         Introduction                                 Replying mail
  51.  
  52. 638
  53. REPLYING TO MAIL
  54.  
  55. If you'd like to reply to a message you're reading, choose "Reply" from the Mail menu, or click the "REPLY" button on the Palette.  A new outgoing message will be created, and the appropriate information will be entered for you.  If you select some text in the incoming message before replying, the selected text will be copied to the outgoing message and formatted as a quote, following the options you've set in Quoting Preferences.  (See the Preferences chapter for details.)
  56.  
  57. You may also choose to reply to all addressees, just the sender, or just the conference by using the Reply special item under the Mail menu.
  58.  
  59. *BulkRate Help         Introduction                                 Forwarding mail
  60.  
  61. 283
  62. FORWARDING MAIL
  63.  
  64. You may also forward an incoming message to someone else by choosing "Forward" from the Mail menu or clicking the "FWD" button on the Palette.  The entire text of the message will be copied to a new outgoing message, ready for you to add new addressing information.
  65.  
  66.  
  67. *BulkRate Help         Introduction                                 Creating new mail
  68.  
  69. 168
  70. CREATING A NEW OUTGOING MESSAGE
  71.  
  72. You may create a new, blank outgoing message by choosing "Compose new" from the Mail menu or clicking the "NEW" button on the Palette.
  73.  
  74.  
  75. *BulkRate Help         Service files                                Service window
  76.  
  77. 989
  78. SERVICES
  79.  
  80. A service file stores important information for each "service" or BBS. This information is divided over five windows:
  81.  
  82. Service window:
  83.  
  84. Host name: 
  85.      The name of the service or BBS.  For the Address Book to work correctly, it's important that this name match the Service name in any Address Book entries for that service.  (If the BBS is gatewayed to other BBSs, use the name that appears after the comma on gated messages.)
  86.  
  87. UserID: 
  88.      This is your unique account name on that BBS; it may be the same as your screen name, it may not.  If you convert an existing FirstClass settings file, the UserID is automatically imported for you.
  89.  
  90. Password: 
  91.      Your password on the FirstClass BBS.  Again, this can be automatically imported from a FirstClass settings file.  Note that passwords and UserIDs that use extended characters (characters generated by holding down the option key, or with ASCII values higher than 127) cause problems with the CLUI, and thus with BulkRate.
  92.  
  93.  
  94. *BulkRate Help         Service files                                Mailbox settings
  95.  
  96. 1057
  97. MAILBOX SETTINGS
  98.  
  99. Incoming mail filename and Outgoing mail filename.
  100.      These two entries are very important.  They determine which files BulkRate will use for incoming and outgoing mail for that BBS.  Although you can type into the appropriate fields, I recommend that you use the "Create" buttons to create new files, this way you can choose the location of these files as well.  (The location must be on a mounted volume; BulkRate will not mount network volumes for you.)
  101.  
  102. Auto-delete... mail on close
  103.      If checked, these will casue mail that has been marked as read or sent mail (as appropriate) to be automatically deleted when you close a list window.
  104.  
  105. Auto-delete mail over... days old
  106.      If you check this and enter a number of days, amil older than the number of days you specify will be flagged for delete when you open the mailbox.  This will result in automatic deletion when you close the window unless you reset the flags manually.
  107.  
  108. Sort/Reverse sort
  109.      These options allow you to specify how you would like each mailbox to be sorted.
  110.  
  111. *BulkRate Help         Service files                                Exchange settings
  112.  
  113. 3385
  114. EXCHANGE SETTINGS
  115.  
  116. "Look for conferences in:" (Conference path list)
  117.     The conference path list is simply a list of paths to conferences.  The default is:
  118.  
  119. Home
  120. Home:BulkRateToRead
  121.  
  122.      This default instructs BulkRate to read all flagged conferences on the Desktop (Home) and inside the "BulkRateToRead" folder, which can be found on the Desktop.  
  123.      Do not put the names of actual conferences here unless you wish BulkRate to look for flagged conferences INSIDE those conferences.  In other words, if there is a conference called "Member Forum" on the Desktop, "Home" is enough to get BulkRate to find it.  "Home:Member Forum" would fail.
  124.      Do not make the mistake of putting "Home:Mailbox" in this list.  This would cause BulkRate to open your Mailbox and look for flagged conferences INSIDE your mailbox.  Instead, if you wish to have BulkRate read your Mailbox, the default entry of "Home" should do it for you, since your Mailbox is in the "Home" or Desktop level.
  125.      Note that due to a limitation of the FirstClass CLUI (Command Line User Interface), you cannot specify paths that include spaces.  That's why the default "BulkRateToRead" folder has no spaces in its name.
  126.      You can create additional folders on your desktop and have BulkRate read what's in them simply by adding more lines to the conference path list; for example:
  127.  
  128. Home
  129. Home:BulkRateToRead
  130. Home:OtherToRead
  131.  
  132. "DON'T read these conferences:" (Don't read list)
  133.      This list simply tells BulkRate which conference not to read; this is especially useful if there are conferences on the Desktop you do not want BulkRate to read.  (Otherwise, simply do not place their aliases in the BulkRateToRead folder.)  Put each conference name on a seperate line. Do not include path information.
  134.  
  135. "DON'T read messages from these people:" (Kill list)
  136.      Similar in concept to the above list; this list targets certain people whose messages you do not want BulkRate to read.  Besides putting annoying people in this list, you can also put yourself in this list to keep BulkRate from picking up mail you have just sent.  Put each nme on a seperate line.
  137.  
  138. Your screen name:
  139.      If you would like BulkRate to refrain from putting your name into the cc list when to reply to a message, put your name as it appears on the BBS in this field.  This may or may not be the same as your UserID.
  140.  
  141. Use threaded replies:
  142.      This checkbox controls whether or not Bulkrate records the information needed for threaded replies when you generate a reply.  See the section on threaded replies for more info.
  143.  
  144. Delete mail on server...:
  145.      Checking this option will cause BulkRate to delete messages in your FirstClass MailBox in excess of the number you specify.  Enter the maximum number of messages to keep in your FirstClass MailBox.  After sending your outgoing mail and processing file retreival requests, BulkRate will delete any messages in your FirstClass MailBox in excess of this number.
  146.  
  147. Split outgoing messages at ____ characters:
  148.      The FirstClass CLUI message editor tends to crash when messages that are too large are uploaded.  To work around that problem, BulkRate divides large messages into smaller chunks.  This option controls how large those chunks will be.  You may enter a size between 1000 and 32000 characters; the optimum size will vary from server to server and may require some experimentation.
  149.  
  150.  
  151. *BulkRate Help         Service files                                File transfer settings
  152.  
  153. 374
  154. FILE TRANSFER SETTINGS
  155.  
  156. This dialog allows you to tell BulkRate from which conferences you would like BulkRate to automatically download files, and how large you will allow an automatically downloaded file to be.  Remember that you can always issue a file retreival request to have BulkRate retreive an attached file.
  157.  
  158. See the section on File Transfers for more information.
  159.  
  160. *BulkRate Help         Mailbox files                                Mailboxes and archives
  161.  
  162. 2353
  163. MAILBOXES AND ARCHIVES
  164.  
  165. BulkRate stores all mail in specially formatted text files which are called mailboxes.  There are two formats, one for incoming mail and another for outgoing mail.  Each service has an incoming mailbox and an outgoing mailbox associated with it.  You can set up or change this relationship by choosing "Mail settings..." under the Service menu.
  166.  
  167. On the right side of the Mail settings dialog are some fields and buttons that allow you to specify the name and location of the files you wish to use for Incoming and Outgoing mail.  There are basically two strategies you can use.  The first strategy is to use one incoming mail file and one outgoing mail file for all services.  The second strategy is to use separate files for each service.  For example, if you call LAMG BBS and DigitalPopcorn, you might have the following files:
  168.  
  169. LAMG BBS
  170.      Outgoing mail filename: LAMG Outgoing
  171.      Incoming mail filename: LAMG Incoming
  172.  
  173. DigitalPopcorn
  174.      Outgoing mail filename: DP Outgoing
  175.      Incoming mail filename: DP Incoming
  176.  
  177.  
  178. There are two advantages to using separate files: one, better organization, since messages from multiple BBSs don't end up in the same list, and two; it's easier to use BulkRate to read and write messages for one BBS while BulkRate is exchanging mail with another BBS.  The main disadvantages are that there are more files to keep track of, and it becomes easier to accidentally store replies or other outgoing mail in the wrong mailbox.
  179. (A third strategy that would eliminate that last disadvantage would be to use separate Incoming mail files for each service, but a single Outgoing mail file for all services.)
  180.  
  181. Archives are identical in format to mailboxes.  Archives can simply be thought of as inactive mailboxes.  If you choose "Save a copy as..." or "Archive selection..." under the File menu, you can create archives to store mail for later reading or printing.  "Save a copy as..." copies the entire mailbox to a new archive, "Archive selection..." copies the selected items to a new archive, and "Append to archive..." copies the selected items to the end of an existing archive.  (Note that since archives and mailboxes are really the same thing, you can append items to an "active" mailbox if you wish.  This might be useful for copying outgoing mail to be sent to several different BBSs.)
  182.  
  183. *BulkRate Help         Mailbox files                                Services and Mailboxes
  184.  
  185. 1211
  186. THE POTENTIALLY CONFUSING BUT VITALLY IMPORTANT RELATIONSHIP BETWEEN SERVICES AND MAILBOXES
  187.  
  188. It is very important to understand the relationship between Service files and Mailboxes.  This relationship is defined under Mail settings... under the Services menu.
  189.  
  190. Each Service can be thought of as "owning" two files or mailboxes: an outgoing mailbox and incoming mailbox.  When you click on the "Incoming mail" or "Outgoing mail" icons in the Service window, BulkRate opens the file that is listed in the "Mail settings" dialog.  If you are reading incoming mail and decide to make a reply, the reply is created in the Outgoing mailbox that belongs to the currently open Service file.  This is a very important concept to understand: if you happen to be reading mail in an incoming mailbox that belongs to LAMG BBS, but you have the DigitalPopcorn service file open, the reply will be created in the DigitalPopcorn outgoing mailbox, which is probably not what you want.  The moral is that you should insure that the matching Service file is open when you are reading mail from a BBS.  (Again, it might be possible to minimize this problem by using the third mailbox strategy outlined in "Mailboxes and archives".)
  191.  
  192. *BulkRate Help         Windows                                      Service window
  193.  
  194. 1212
  195. SERVICE WINDOW
  196.  
  197. This window contains information for the currently active Service, as well as clickable icons that act as shortcuts for exchanging mail and opening incoming or outgoing mail.
  198.  
  199. The service name is the name you wish to use to identify the BBS.  If you call multiple BBSs, make sure each has a unique name.  If you have multiple Service files for a single BBS, all files should have the same service name entered here.
  200.  
  201. The UserID and Password must be identical to those used in FirstClass Client.  An easy way to insure this is to have BulkRate pull the UserID and Password from a FirstClass Settings file.  Simply choose "Open service..." from the Service menu and choose a FirstClass settings file.  BulkRate will create a new Service file and enter host name, UserID, password, and a phone number for you.  You must still adjust your Mail settings and Modem settings.
  202.  
  203. When you type in a password, it will appear in readable text.  Hit the tab key to convert it to "bullets" for security.  Clicking back into the Password field will make the password readable again.
  204.  
  205. Click "Exchange mail now" to start a mail exchange.  Click "Incoming mail" or "Outgoing mail" to view the respective mailboxes.
  206.  
  207. *BulkRate Help         Windows                                      Incoming message list
  208.  
  209. 1166
  210. INCOMING MESSAGE LIST WINDOW
  211.  
  212. This window shows you a list of all messages in a incoming mailbox.  You may read any item in the list by double-clicking on it.  Option-clicking an item toggles the flag which indicates that a message has been read.  You may also mark an item as read by choosing "Mark as unread" from the Mail menu.
  213.  
  214. You can sort the list by Conference, Name, Subject, Date or read/unread Status using the View menu.  The "by Default" sort type simply shows you the items in the order they are stored in the file.
  215.  
  216. You may delete items by selecting them and choosing "Mark for delete" from the Mail menu, or clicking the Delete button on the Palette.  This marks the items with a trashcan icon.  When you close the list window, these items will be removed from the mailbox file.
  217.  
  218. Choosing Forward from the Mail menu, or clicking the Palette FWD button will allow you to forward a selected message to another recipient.
  219.  
  220. Choosing Reply from the Mail menu or clicking the Palette REPLY button will create a reply to a selected message.  It's better to reply to a message that is open, however, as this allows you to quote text from the original message.
  221.  
  222. *BulkRate Help         Windows                                      Incoming mail
  223.  
  224. 1573
  225. INCOMING MESSAGE WINDOW
  226.  
  227. You may read an incoming mail item using this window.  You may copy and edit text and change the font and size of selected text, but no changes are saved when you close the window or advance to another message.  You may quickly advance to the next message by pressing the return, enter or right arrow keys.  You can return to the previous message by pressing the left arrow key.  You may also use the Mail menu or Palette for more navigation options.
  228.  
  229. The space  bar can be used to somewhat intelligently step through messages: the current thread will be followed until there are no messages left in the thread, then it will read the first unread message in the list; follow its thread, if any, and so on until all unread messages are read.
  230.  
  231. Choosing Forward from the Mail menu, or clicking the Palette FWD button will allow you to forward this message to another recipient.
  232.  
  233. Choosing Reply from the Mail menu or clicking the Palette REPLY button will create a reply to this message.  If you wish to quote part of the message text in the reply, select the text before choosing or clicking "Reply."
  234.  
  235. If the message has files attached to it and you haven't configured BulkRate to automatically download file attachements, you may request that Bulkrate retreive any attached files on the next mail exchange by choosing "Request file" from the Mail menu, or by clicking the RQST button on the Palette.
  236.  
  237. Clicking the Palette DEL button or choosing "Mark for delete" from the Mail menu will mark this message for deletion and advance to the next message.
  238.  
  239. *BulkRate Help         Windows                                      Outgoing mail list
  240.  
  241. 1362
  242. OUTGOING MAIL LIST WINDOW
  243.  
  244. This window is similar to the Incoming mail list window. It displays a list of all messages in an outgoing mailbox.  Option-clicking an item toggles the sent flag, which looks like a postmark.  This flag indicates that a message has been sent; unsent items will have no icon. Items that have been put on "hold" will have a hollow flag icon, and items marked for deletion will have a trashcan icon.   Items that were attempted to be sent, but failed, will be indicated with a circle-with-a-slash icon.  You can check the log for details as to why this message wasn't sent.  BulkRate will also send you a "non-delivery notification" which will appear in your incoming mailbox.  In most cases, the problem is an addressing problem.
  245.  
  246. You may sort the list by Service, Name, Subject, Date or sent/unsent Status by using the options available under the View menu.  Again, the "by Default" sort type simply displays the items in the order they exist within the mailbox file.
  247.  
  248. Double-click an item to open it for reading or editing.
  249.  
  250. You may delete items by selecting them (shift-click and command-click are supported) and choosing "Mark for delete" from the Mail menu, or clicking the Delete button on the Palette.  This marks the items with a trashcan icon.  When you close the list window, these items will be removed from the mailbox file.
  251.  
  252. *BulkRate Help         Windows                                      Outgoing mail
  253.  
  254. 1828
  255. OUTGOING MAIL WINDOW
  256.  
  257. Use this window to edit outgoing mail.  Once you've created a new message, you can either Save it (under the File menu) or Queue to Send it (under the Mail menu).  Both actions are equivalent; Queue to Send (or the Palette "Post" button) takes the additional step of closing the window after saving the message in the outgoing mailbox.  Due to limitations of the FirstClass CLUI, outgoing messages over 5K in length will be automatically split into multiple parts when sent.  The FirstClass CLUI also does not recognize extended characters when composing mail.  Any extended characters you enter in the subject or body text of an outgoing message will be converted to regular ASCII text when the message is sent.  For example, "Günther" will be converted to "Guenther", and "BulkRate©" will be converted to "BulkRate(c)”.
  258.  
  259. When editing an outgoing message, you can add addresses to the To or cc fields manually, or by using the Address Book.  
  260.  
  261. "Host:" contains the host name of the BBS this message is to be sent to; usually BulkRate fills this in for you.
  262.  
  263. The "Message sent" checkbox will be checked if you are viewing or editing a message that has already been sent to the Host BBS.  You can also manually toggle this to re-send the message .
  264. The "Hold message" checkbox can be checked to prevent BulkRate from sending a message.  You can then finish it at a later time and the uncheck this box.  This checkbox changes to "Delete message" if the message has been sent.
  265. The "Threaded reply" checkbox indicates whether or not a message is a threaded reply.  Uncheck this box to de-thread the reply.  Do not uncheck this box on a file retreival request, or the request will fail.
  266.  
  267. Clicking the Palette DEL button or choosing "Mark for delete" from the Mail menu will mark this message for later deletion. 
  268.  
  269. *BulkRate Help         Windows                                      Address book
  270.  
  271. 2188
  272. ADDRESS BOOK WINDOW
  273.  
  274. This window simply contains a list of names, addresses, and services.  If an outgoing message is directly under the Address Book window, double-clicking on an entry (or selecting an entry and clicking the "Use" button) will add that address to the To field, unless the cursor was in the cc field, in which case the address will be added to the cc field.
  275. Another way to use the Address Book is to simply type the name into the To or CC fields of an outgoing message.  When you hit return, enter, or tab, the name will be replaced with the address you've entered (and a comma and the Host Service, if applicable).  For example, if you typed "Greg Neagle" and hit return, "Greg Neagle" would be replaced with "greg_neagle@pop.com,Internet".
  276. You may edit the items in the Address Book by clicking the Edit button, which expands the window to include the editor section.
  277. Add an address by typing it into the fields in the editor section and clicking "Add".
  278. You can add, delete, and replace Address Book items, open other address book files, or save the current Address Book as a new file.  Any Address Book file that is open when you quit BulkRate becomes the default Address Book and will be re-opened the next time you launch BulkRate.
  279.  
  280. Address Book edit fields:
  281.  
  282. Name: 
  283.      Stores the name of the addressee: you can put anything you want here, like "Dad", or "BulkRate tech support" - whatever name allows you to easily remember the entry.
  284.  
  285. Address: 
  286.      This is the actual FirstClass address or gatewayed address.
  287.  
  288. Host service: 
  289.      If the person is accessed through a gateway, this is the name of the gateway or FirstClass BBS accessed through a gateway.
  290.      For example: if you wanted to enter my address, and your FirstClass BBS has a gateway to Internet e-mail called "Internet", you could put "Greg Neagle" in the Name field, "greg_neagle@pop.com" in the Address field, and "Internet" in the Host service field.
  291. Otherwise, this name should EXACTLY match the Host name in the Service window, or you can leave it blank.
  292.  
  293. Notes:  
  294.      Use this field to store a note or memo concerning the current entry.  It will only be visible while editing the Address Book.
  295.  
  296. *BulkRate Help         Windows                                      Palette
  297.  
  298. 2095
  299. PALETTE WINDOW
  300.  
  301. This windows serves much like FirstClass Client's palette window - it gives you easy one-click access to many message navigation and creation functions.  Normally the Palette opens in a vertical configuration, but if you hold down the option key while choosing "Palette" from the View menu, it will open in a horizontal configuration.  As long as the Palette is open while you quit BulkRate, it will re-open automatically in the same configuration when you re-launch BulkRate.
  302.  
  303. Palette buttons:
  304.  
  305. NEW: creates a new outgoing message in the outgoing mailbox for the currently open service.
  306.  
  307. POST: Queues an outgoing message to be sent. (The outgoing message is saved in the outgoing mailbox and the window is closed.)  Note that this mail is not actually sent until you choose "Exchange mail now" or otherwise initiate a mail exchange.
  308.  
  309. REPLY: Creates a reply to the current incoming message.  If you have selected text in the incoming message before clicking "REPLY," the text will be quoted in the outgoing message.
  310.  
  311. FWD: Creates a new outgoing message that forwards the text of the current incoming message to new recipient.
  312.  
  313. ATTCH: Attaches a file to an outgoing message.
  314.  
  315. RQST: Request that an attached file be retreived from the server on the next mail exchange.
  316.  
  317. FIND: Allows you to find text in a mailbox or the log.  Holding the option key down as you click this button is the same as choosing "Find text again" from the menu.
  318.  
  319. DEL: Marks to deletion the currently open message, or any selected messages in a list window.
  320.  
  321. PREV THRD: (Previous in Thread) Finds the first previous message with the same subject as the current message.  This is not "true" threading, but is the best possible approximation.
  322.  
  323. NEXT THRD: (Next in Thread) Finds the next message with the same subject as the current message.
  324.  
  325. FIRST UNRD: (First Unread) Finds the first unread message in the list.
  326.  
  327. NEXT UNRD: (Next Unread) Finds the next unread message after the current message.
  328.  
  329. PREV MSG: (Previous message) Displays the previous message.
  330.  
  331. NEXT MSG: (Next message): Displays the next message.
  332.  
  333. *BulkRate Help         Windows                                      Mail log
  334.  
  335. 295
  336. MAIL LOG WINDOW
  337.  
  338.  
  339. This window displays the contents of the BulkRate log, which can be useful for troubleshooting, reviewing the actions a script accomplished, determining why certain messages were not sent, or determining logon and logoff times.  BulkRate saves only the last 30-32K of activity.
  340.  
  341. *BulkRate Help         Windows                                      Exchange status
  342.  
  343. 200
  344. EXCHANGE STATUS WINDOW
  345.  
  346. This window is visible whenever a mail exchange is in progress.  It displays information about the current exchange.  Click the Cancel button to cancel an exchange in progress.
  347.  
  348. *BulkRate Help         Menus                                        File menu
  349.  
  350. 1446
  351. FILE MENU
  352.  
  353.  New: 
  354.      Creates a new outgoing message in the Outgoing mailbox owned by the currently open Service.
  355.  
  356.  Open: 
  357.      Allows you to open any text file, which includes mailboxes, archives, the Address Book, the BulkRate log, and any other text file.  A text file that is not of one of the above types will be opened as the text of a new outgoing message.
  358.  
  359.  Close: 
  360.      Closes the topmost open window.  If you close a mailbox list window, all associated message windows will close as well.
  361.  
  362.  Save: 
  363.      This item is only active when there is a outgoing message in the top window.  Use it to save outgoing mail in the outgoing mailbox.
  364.  
  365.  Save a copy as.../Save as text...: 
  366.      This item changes depending on which window is topmost; you can create a copy of a mailbox and all messages within, or you may save any message as a text file (creator type is TeachText).
  367.  
  368.  Archive selection.../Archive message...: 
  369.      If you have messages selected in a mailbox list window, you can use this command to save them in a separate archive, or if the topmost window is a message window, you can save the current message as a new archive.
  370.  
  371.  Append to archive...: 
  372.      Use this command to append selected mailbox list items or the current message to an existing archive or mailbox.
  373.  
  374.  Page setup...: 
  375.      Brings up a standard Page Setup dialog.
  376.  
  377.  Print...: 
  378.      Allows you to print the text of a message or the log.
  379.  
  380.  Quit: 
  381.      Quit BulkRate.
  382.  
  383. *BulkRate Help         Menus                                        Edit menu
  384.  
  385. 1624
  386. EDIT MENU
  387.  
  388.  Undo: 
  389.      Allows you to undo text changes.  You cannot, however, undo the saving or deleting of a message.
  390.  
  391.  Cut, Copy, Paste, Clear: 
  392.      Allow you to do the standard editing functions on text.
  393.  
  394.  Select all: 
  395.      Use to select all text, or all messages in a list.
  396.  
  397.  Font, Size: 
  398.      Use these menus to temporarily change the font and/or size in an incoming message; this might be useful to line up columns in a message originally composed in a monospaced font.  If you'd like to permanently change the default font and size of text in messages, use "Preferences..." under the Service menu.
  399. Font and Size are not available when editing test in an outgoing message because there is no way to send font and style information to the FirstClass CLUI.
  400.  
  401.  Find text, Find text again
  402. Use these to find text in a mailbox or the log.  BulkRate will search through all the messages in an open mailbox to find the requested text.
  403.  
  404.  Preferences...
  405.      Opens a dialog allowing you to specify how BulkRate behaves in various situations.  These are global settings and are not saved with each Service, but rather apply to every Service.  See the Preferences section for more details.
  406.  
  407.  Register...
  408.      Opens a dialog that allows you to register BulkRate.  Remember: BulkRate is now shareware.  I ask $25 US as a shareware payment. Once you enter the registration code, the "- sent by an evaluation copy of BulkRate (unregistered)" tagline will cease to be added to your outgoing messages.  File transfers are disabled in the evaluation version of BulkRate.  If you register BulkRate, file transfers will become available.
  409.  
  410. *BulkRate Help         Menus                                        Mail menu
  411.  
  412. 2463
  413. MAIL MENU
  414.  
  415.  Compose new
  416.      Creates a new outgoing message in the outgoing mailbox "owned" by the currently open Service file.
  417.  
  418.  Queue to send
  419.      Saves an outgoing message in the outgoing mailbox, then closes the window.  This does not actually send the message to the host BBS.  You must initiate a mail exchange to actually send the message.  Due to limitations of the FirstClass CLUI, any message that is over 5K in length will be automatically split into multiple parts when sent.
  420.  
  421.  Reply
  422.      Creates a reply to an incoming message.  If text is selected in the incoming message, it will be automatically "quoted" to the new outgoing message.  You can customize how the text is quoted by selecting Preferences... under the Edit menu.
  423.  
  424. Reply special
  425.      Allows you to direct a reply to all addressees, the sender only, or the conference only, overriding the default reply behavior, which is to send to the conference only for conference replies, and to all for MailBox replies.
  426.  
  427.  Forward
  428.      Allows you to forward an incoming message.
  429.  
  430.  Next unread
  431.      Opens the next unread message in the list.
  432.  
  433.  Next thread
  434.      Finds and opens the next message in the list with the same subject (or variation thereof) as the current message.  This is not "true" threading, but is all that is possible with the CLUI interface.
  435.  
  436.  Mark for delete
  437.      Marks the current message (or currently selected messages in a list) for later deletion.  When the list window is closed, messages marked for deletion will be removed from the mailbox.  If you hold down the option key while selecting this, the name of the menu item changes to simply "Delete" and it immediately deletes the current message, or multiple messages if more than one is selected in a message list. 
  438.  
  439.  Mark as unread
  440.      Use this command to mark the currently selected messages in an incoming list as unread, or mark the current incoming message as unread.
  441.  
  442.  Attach file
  443.      Prompts for a file to attach to an outgoing message.
  444.  
  445.  Request file
  446.      Generates a file retreival request if the current incoming message has one or more attached files.
  447.  
  448.  Exchange mail now
  449.      Use this command to start a mail exchange with the currently open service.
  450.  
  451.  Exchange mail later...
  452.      This command allows you to specify a future time for a mail exchange to begin.
  453.  
  454.  Script...
  455.      Opens the script dialog, which allows you to create, edit, open, save, and run scripts.  See the Scripting section for more details.
  456.  
  457. *BulkRate Help         Menus                                        Service menu
  458.  
  459. 722
  460. SERVICE MENU
  461.  
  462.  New service
  463.      Creates a new empty Service file.
  464.  
  465.  Open service...
  466.      Allows you to open a Service file, or convert an old BulkRate settings file, or a FirstClass settings file.  Note that if you are "converting" a FirstClass settings file that the only information converted is Host name, UserID, Password, and Phone number.  Modem settings and mail settings will have to be entered by you.
  467.  
  468.  Save service...
  469.      Allows you to save changes to a Service file.
  470.  
  471.  Save service as...
  472.      Allows you to save a Service file under a different name.
  473.  
  474.  Service setup...
  475.      Opens a dialog allowing you to set various options pertaining to the current service.  See the Service setup section for more details.
  476.  
  477. *BulkRate Help         Menus                                        View menu
  478.  
  479. 1403
  480. VIEW MENU
  481.  
  482.  by Default  through  by Status:
  483.      This group of menu items allow you to sort a message list to your liking. "by Subject" does a pseudo-thread sort, grouping messages by Conference, Subject, and Date.  "by Status" groups read/unread items or sent/unsent/can't send items.  "by Default" simply displays the items in the order they exist with in the mailbox file, and is the fastest.
  484.  
  485.  Reverse sort
  486.      Reverses the direction of the selected sort.
  487.  
  488.  Address book
  489.      Opens the Address book.  See the BulkRate Windows:Address book section for more details.
  490.  
  491.  Palette
  492.      Opens the Palette.  See the BulkRate Windows:Palette section for more details.  If you hold the option key down while opening the Palette, it will open in a horizontal configuration.
  493.  
  494.  Log
  495.      Opens the log.  The log is simply a text file detailing BulkRate's past actions.  If it grows to over 32K in size, BulkRate deletes old material to bring it under 32K.  You can cause BulkRate to write more detailed information to the log by checking "Include debugging info in log" under Preferences.
  496.  
  497.  Incoming mail
  498.      Opens the incoming mailbox "owned" by the currently open Service file.
  499.  
  500.  Outgoing mail
  501.      Opens the outgoing mailbox "owned" by the currently open Service file.
  502.  
  503. All other menu items in this menu are the names of currently open windows.  You can quickly switch to another open window via these items.
  504.  
  505. *BulkRate Help         Preferences                                  General preferences
  506.  
  507. 1137
  508. GENERAL PREFERENCES
  509.  
  510. Include debugging info in log:
  511.      When this option is chosen, virtually everything that comes over the modem port is written to the log file.  This can be useful for determining why BulkRate isn't working as one would expect, since it allows you to see exactly what is being sent by the FirstClass CLUI.
  512.  
  513. Palette button sounds: 
  514.      Turns on or off the sounds made when clicking a palette button.
  515.  
  516. Use a message tag line:
  517.  This allows you to add random one-line "tags" to the end of your messages.  BulkRate will pick a single line at random from this list and add it to end of your outgoing messages.  Note that this is a tagline, not a signature file.  For information on creating and using signature files, see Adding a ‘signature’ to your messages in the Hints and Tips chapter of this document.
  518.  
  519. Max redials/Redial delay
  520.      Use these to tell BulkRate how many times to try dialing a BBS  before giving up, and the time in seconds to wait between attempts.
  521.  
  522. Default font/Size
  523.      Use these pop-up menus to choose the default font and size in which you would like incoming and outgoing mail to be displayed.
  524.  
  525. *BulkRate Help         Preferences                                  FirstClass preferences
  526.  
  527. 1145
  528. FIRSTCLASS PREFERENCES
  529.  
  530. These are related to the Preferences you can set in FirstClass Client.  It's important to set these to the way you'd like them set when using FirstClass Client, as BulkRate changes the preferences to what it requires during a mail exchange.  It uses the settings in this window to reset the FirstClass Preferences. 
  531.  
  532. Show items in conferences in reverse order
  533.      This causes FirstClass to show list items with the newest items first.  Set this to however you'd like it to be when using FirstClass Client.
  534.  
  535. Show only unread items in conference
  536.      This causes FirstClass to hide items you've already read.  BulkRate automatically turns this setting on when it does a mail exchange; if you uncheck this, BulkRate will turn it back off as it logs off.
  537.  
  538. Don't accept invitations
  539.      This keeps chat requests from coming to you; BulkRate automatically turns this setting on when it does a mail exchange; if you uncheck this, BulkRate will turn it back off as it logs off.
  540.  
  541. Sounds during chat and invite
  542.      This controls sounds during a chat session.  Set this to however you'd like it to be when using FirstClass Client.
  543.  
  544. *BulkRate Help         Preferences                                  Quoting preferences
  545.  
  546. 555
  547. QUOTING PREFERENCES
  548.  
  549. Wrap text at ___ characters
  550.      Controls the width of quoted text.  Set this to 0 if you don't want BulkRate to wrap quoted text at all.  70 works well because it allows quoted text to be requoted without going over 80 characters.
  551.  
  552. Include attribution line
  553.      This controls whether or not BulkRate precedes quoted text with a line giving attribution to the originator.  It's good form to do so.
  554.  
  555. Quote characters
  556.      This group of controls allows you to customize what characters BulkRate uses to proceed each line of quoted text.
  557.  
  558. *BulkRate Help         File transfers                               Downloads
  559.  
  560. 2577
  561. FILE TRANSFERS
  562.  
  563. BulkRate supports file transfers.
  564. File transfers are available only on registered copies of BulkRate.
  565.  
  566. Downloads
  567. There are two ways to have BulkRate download files that are attached to messages.  The first is to specify which from conferences you would like BulkRate to automatically download files under a certain size.  You can do this by choosing "Service setup..." under the Service menu, then clicking on the File Transfers icon.
  568.  
  569. In this dialog, you can enter the names of conferences in which BulkRate should automatically download file attachments, and the size limit on these automatic downloads.  The default setting is to automatically download any files under 100K attached to messages in your MailBox.  Any files downloaded will appear in a folder named "BulkRate downloads" in the same folder as the BulkRate application.
  570.  
  571. The second way to download files with BulkRate is a two-step process: step one is a normal mail exchange, in which BulkRate only retreives the text of messages and ignores file attachements.  If while reading through the incoming mail you notice a file you want, you can then Choose "Request file" under the Mail menu, or click the RQST button on the Palette.  This will cause BulkRate to create what looks like a threaded reply, but in actuality is a File Request - a command and the information needed to retreive the desired file or files during the next exchange.
  572. Note: there is nothing preventing you from editing a File Request message, but if you want the Request to actually work, do not edit it with the exception of removing a file or files from the list of those to retreive.  (This may happen if a given message has multiple files attached to it.)
  573. Click POST on the Palette or choose "Queue to send" from the Mail menu, and the request will be saved to your outgoing mailbox.
  574. During the next mail exchange, while sending mail, BulkRate will also retreive any files requested by you.  Note that the file retreival is not a seperate process, but rather is interleaved with the sending of mail.  You could easily have a new message, a file retreival request, another new message, another file request, and a reply to a message in that order in your outgoing mail.  BulkRate will process the items in your outgoing mail in the order they are saved to the outgoing mail file.  Again, any files downloaded will appear in a folder named "BulkRate downloads" in the same folder as the BulkRate application.  A message will appear in your incoming mailbox to inform you of the success or failure of the retreival request.
  575.  
  576. *BulkRate Help         File transfers                               Uploads
  577.  
  578. 672
  579. UPLOADS
  580.  
  581. You may attach files to outgoing messages with the "Attach file" item under the Mail menu and the "ATTCH" button on the Palette.  The paths to these files will appear in the "Attached files" field on the Outgoing mail window.  The files themselves are not saved or copied in any way.  When the mail exchange occurs, BulkRate will expect to find the file(s) in the same place as when you attached the file to the message.  If you move the file, rename it, or rename any folder in the path to the file, BulkRate will not be able to locate the file.
  582. You can delete an attached file from a message by clicking on its path and pressing the delete key on your keyboard.
  583.  
  584. *BulkRate Help         File transfers                               Protocols
  585.  
  586. 511
  587. FILE TRANSFER PROTOCOLS
  588.  
  589. BulkRate uses the XModem-1K CRC file transfer protocol for all file transfers.  This protocol was chosen for the following reasons:
  590. 1) It is much easier to program than the ZModem protocol.
  591. 2) ZModem in the FirstClass CLUI seems to fail on occasion, causing a crash of the CLUI session, much the same way an overly large message can crash the CLUI message editor.
  592.  
  593. Unless SoftArc fixes the ZModem implementation in the CLUI, I have no intention of adding support for ZModem to BulkRate.
  594.  
  595. *BulkRate Help         Threaded replies                             Threaded replies
  596.  
  597. 3858
  598. THREADED REPLIES
  599.  
  600. BulkRate supports threaded replies.  This means that replies you generate with BulkRate will be properly inserted into the appropriate thread.  This will allow people using FirstClass Client to follow threads and find your replies using the "Next Thread" function in FirstClass Client, and message histories will now show your replies.  Some BBSs discourage the use of BulkRate because its replies have fallen outside the threads; now this will no longer be the case.
  601.  
  602. You can turn on threaded replies for a given service by choosing "Service setup..." under the Service menu.  Click the "Exchange Settings" icon. Check "Use threaded replies".  You may also want to add your screen name as it appears on that service to prevent replies from being sent back to your mailbox.  Close the dialog by hitting "OK" and save the changed service file by choosing "Save service" under the Service menu.
  603.  
  604. Drawbacks
  605.   There are two major drawbacks to threaded replies, which is why they are implemented as an option in BulkRate:
  606. 1) Posting a threaded reply is slower than posting a new message or a non-threaded reply.
  607. 2) Threaded replies have constraints on addresses placed in the To and cc fields of a message.
  608.  
  609. How threaded replies work
  610.   When you create a reply, information is stored with the reply that tells BulkRate what conference the original message was in, how to get to that conference from the Desktop, and identification information for the actual original message in the conference (a message "header").
  611.   During an exchange, when a threaded reply is found, BulkRate navigates to the original conference and opens it, requesting a list of all messages in that conference. (This can be rather time consuming if the conference has many messages in it.)  It then finds the original message in the message list and sends a command to reply to that message.  The FirstClass CLUI then starts a reply and lets BulkRate finish it.
  612.   The fact that the FirstClass CLUI starts the reply for you places some constraints on message addressing.  The addresses that the FirstClass CLUI automatically enters when generating a reply cannot be removed from the reply.  You may add addresses, but you cannot remove any.  If, while editing a reply in BulkRate, you remove any existing addresses or press the delete key while editing either address field, the reply will no longer be treated as a threaded reply to prevent copies of the message from going to people or conferences you do not expect.
  613.   
  614. Threaded or not?
  615.   You can choose to enable threaded replies for a given service or not; you may also elect to "de-thread" any given reply by unchecking the "Threaded reply" checkbox in the Outgoing message window.  Why might you want to NOT use threaded replies?  Since BulkRate must ask for a message list that includes EVERY message in the original conference in order to locate the original message, this can get quite slow.  (BulkRate is smart enough to use the list for multiple replies to the same conference, if those replies are next to each other in the outgoing mail file).  This slowness might not bother you with a fast modem, but if you use BulkRate at 2400 bps, it can slow things down quite a bit.  Non-threaded replies and new messages are sent much faster, since there is no need to locate the original message.
  616.   Sometimes the choice is made for you: if you delete any existing addresses from a reply, the reply becomes de-threaded.  In interests of speed, replies to messages in your Mailbox that have been sent only to you and not to any other people or conferences are also initially non-threaded, though you can change that before closing or saving the message.
  617.   In any case, once a reply has been saved as a non-threaded reply, there is no going back: the information that would connect the reply to the orginal message is lost.
  618.  
  619. *BulkRate Help         Scripting                                    Editing scripts
  620.  
  621. 1909
  622. SCRIPTING
  623.  
  624. BulkRate now supports two types of scripts.  The first is a script that tells BulkRate when and with what services to exchange mail, and can be used to automate the exchange of mail with several BBSs.  The second is a log on script, which is similar to FirstClass Client's log on script function and is decribed in the next section.
  625.   You can create documents which tell BulkRate which BBS to exchange mail with, and then what to do afterward.  These scripts can be run manually, or by double-clicking them from the Finder.  To create a script, choose "Script..." from the Mail menu.
  626.  
  627. Run:
  628.      This section determines what will happen if the script if invoked by double-clicking it from the Finder.  If "Manually" is selected, the script will wait for you to run it manually by clicking "Run now" in this window.  If "Automatically when opened" is selected, the script will run immediately after being double-clicked.  If "Wait until:" is chosen, the script will run as soon as the entered time is reached.
  629.  
  630. When finished:
  631.      BulkRate can do one of three things when a script completes: nothing (Wait); quit BulkRate (Quit), or shut down the Macintosh (Shut down).
  632.  
  633. Exchange mail with:
  634.      This list tells BulkRate which Services (BBSs) to exchange mail with when this script is run.  BulkRate will call the first service; if it is busy, it will move on to the next service.  Unless there is an error or the redials exceed the limit you set in Preferences, it will continue trying to exchange with every Service listed here until they've all been completed.
  635. Add services to this list by clicking the Add... button; delete services from the list by selecting one, then clicking Delete.
  636.  
  637. Open...
  638.      Allows you to open a previously saved script.
  639.  
  640. Save as...
  641.      Allows you to save the current script.
  642.  
  643. Cancel
  644.      Exits this dialog without running the script.
  645.  
  646. Run now
  647.      Runs the script now.
  648.  
  649. *BulkRate Help         .fcl log on scripts                          .fcl log on scripts
  650.  
  651. 2430
  652. .FCL LOG ON SCRIPTS
  653.  
  654. BulkRate supports .fcl logon scripts.  These are the same style of logon scripts supported by FirstClass Client.
  655.  
  656. How logon scripts work
  657.    A logon script takes over after the "CONNECT" message is received from the modem.  It then performs a series of actions, typically waiting for certain prompts and sending certain characters until it reaches the end of the script.  At this point, BulkRate expects to be able to proceed normally with the logon process.
  658.  
  659. Do I need a logon script?
  660.   If you do not use a .fcl script currently with FirstClass Client, you do not need a logon script.  Logon scripts are typically used when the connection is routed through one computer before being transferred to the FirstClass Host.  If you do use a .fcl script, the same script will probably work with BulkRate.
  661.  
  662. How do I set up a logon script?
  663.   If you are going to use an existing logon script, make a copy of the one you are using with FirstClass Client.  Rename it "Service filename.fcl", where "Service filename" is the name of the Service file. Put the script in the same folder as the BulkRate application.
  664.   If you are creating a logon script, name it and place it as above.
  665.   BulkRate will look for the script during logon; if it finds one with the proper name, it will run it.
  666.  
  667. How do I write a logon script?
  668.   Here are the supported commands:
  669.  
  670. waitFor "text1" "text2" -t
  671.  
  672.   Waits for text1 or text2 to be received.  Text2 is optional.  t is a timeout value in 1/60ths of a second.  So if you need BulkRate to wait for a password prompt, but proceed after 2 seconds if it isn't received:
  673.  
  674. waitFor "Password:"  -120
  675.  
  676. send "text"
  677.  
  678.   Sends text over the serial port.
  679.  
  680. delay t
  681.  
  682.   Delay t 1/60ths of a second.
  683.  
  684. display "text"
  685.  
  686.    Writes text to the log.
  687.  
  688. Text in all commands supports three special characters, indicated by "\r", "\n", and "\\".  These send a return character, the linefeed character, and the backslash character respectively.
  689.  
  690. A sample logon script might look like this:
  691.  
  692. delay 60
  693. send "\r\r"
  694. waitFor "ID:" -120
  695. send "ABC\r"
  696. waitFor "Password:" -120
  697. send "123\r"
  698. delay 60
  699.  
  700. Now, in English:
  701.  
  702. Delay 1 second.
  703. Send two return characters.
  704. Wait for "ID:" prompt, or 2 seconds, whichever is first.
  705. Send "ABC" and return.
  706. Wait for "Password:" prompt, or 2 seconds, whichever is first.
  707. Send "123" and return.
  708. Delay 1 second.
  709.  
  710. At this point, the standard logon procedure for the FirstClass CLUI would happen.
  711.  
  712. *BulkRate Help         Modems                                       Serial ports
  713.  
  714. 735
  715.  
  716. MODEMS
  717.  
  718. Setting up your modem to work with BulkRate is usually very easy.  Unfortunately, there are many, many modem manufacturers, and so-called "Hayes-compatible" modems are not terribly compatible with each other.
  719. The following info may help you determine the best settings you use with your modem.
  720.  
  721. Serial ports
  722.      BulkRate currently works only with modems connected to the modem port or the printer port.  In some cases, modems ship with software that makes them appear to the Mac to be connected to the modem port, even if they are actually connected to an internal slot, as in the PowerBooks, or to an ADB port, as in the case of some models of Global Village modems.  BulkRate may or may not work with these types of modems.
  723.  
  724. *BulkRate Help         Modems                                       Modem speed
  725.  
  726. 1209
  727. Modem speed
  728.      BulkRate should work with any modem capable of a speed between 1200 bps and 28,800 bps.  Typically,  high-speed modems use a method of connection in which the computer-to-modem speed is higher than the modem-to-modem speed.  With a modem that is rated at 14,400 bps it is usually recommended to raise the serial port speed to 19,200 or 38,400 bps to allow data compression to work.  The speed you specify in the Modem settings dialog is the COMPUTER-TO-MODEM speed, not the modem-to-modem speed.
  729. Upon connecting to the remote modem, your modem returns a "CONNECT" message.  This message can report one of two values, the computer-to-modem speed (DTE speed) or the modem-to-modem speed (DCE speed).  Often it is possible in the initialization string to tell the modem which type of speed report to make.  If your modem is reporting the DCE speed and you are using hardware handshaking, you should uncheck the "Adjust BPS after connect" setting.  If this is checked, BulkRate will readjust the serial port speed to match the speed reported by the CONNECT message.  For low-speed modems, this is usually the right thing to do, but for high-speed modems, this is usually the wrong action to take.
  730.  
  731. *BulkRate Help         Modems                                       Hardware handshaking
  732.  
  733. 1531
  734. Hardware Handshaking
  735.      Most high-speed modems currently support hardware handshaking.  If yours does, you may turn this feature on in the Modem settings dialog.  In fact, BulkRate forces you to do so at serial port speeds greater than 9600 bps.  Make sure you have a modem cable that is properly wired for hardware handshaking.
  736.  
  737.      Note that due to the small number of pins in Macintosh serial ports, most modem cables use the same line to sense DTR (Data Terminal Ready) and to sense CTS (Clear To Send).  The DTR line is often used to support "hardware hangup," in which a voltage transition causes the modem to immediately disconnect.  CTS is one of the hardware handshaking lines.  Since both lines are connected to the same cable pin, a voltage transition on one is indistinguishable from a voltage transition on the other.  If your modem is transferring data too fast for the Mac and the Mac pulls the CTS line to tell the modem to pause a bit, the DTR line will go down as well.  If the modem is set to disconnect on DTR transition, you'll be disconnected.  The bottom line is that in most instances, if you turn hardware handshaking on, you must set the modem to ignore the status of the DTR line. (Typically the correct command is &D0, though your modem may vary.)  Failure to do this will cause unwanted disconnects, especially when downloading or otherwise transferring a lot of data to your Mac.
  738.  
  739. Note also that this advice is not unique to BulkRate; it applies to all uses of high-speed modems with the Macintosh.
  740.  
  741. *BulkRate Help         Modems                                       Initialization strings
  742.  
  743. 1259
  744. Initialization strings
  745.      This can be a source of great confusion and frustration.  In most cases, the default modem settings for use with the Mac are the appropriate ones.  Some manufacturers use "ATZ" to restore these settings, others "AT&F" or "AT&F1".  See your modem manual for details.
  746.      Specifically, your modem must be set up to echo local commands (typically "E1"), provide responses to commands (typically "Q0"), and provide responses in verbal format ( typically "V1").  If you wish BulkRate to properly respond to busy signals and no dialtone situations, the modem must support the "X4" command set.  Given these parameters, a default setup string for a 2400 bps modem would be "ATE1Q0V1X4". 
  747.      If you are using hardware handshaking, this must be turned on in the modem by the setup string, and the modem must be set to ignore DTR.  Unfortunately, the commands to do these things vary incredibly from modem model to modem model, so I can't give you specific commands here.  Your modem manual should be of some help here.
  748.  
  749. Here are some strings that are known to work:
  750.  
  751. Supra: AT&F1 
  752. Global Village: AT&F1
  753. US Robotics Sportster 288: AT&F1
  754.  
  755. Others to try:
  756.  
  757. Generic high-speed modem: AT&F&C0&D0
  758. Generic 2400: ATE1Q0V1X4
  759. Generic 1200: ATE1Q0V1
  760.  
  761. *BulkRate Help         TCP/IP                                       TCP/IP Connections
  762.  
  763. 1117
  764. TCP/IP
  765.  
  766. BulkRate supports TCP/IP connections to FirstClass Servers.   It is beyond the scope of this manual to explain how to configure your Mac for TCP/IP, so it is assumed that you have done so already. 
  767.  
  768. To configure a BulkRate service file to connect via TCP/IP, choose "Service setup..." under the Service menu.
  769. Click "TCP/IP" in the "Connect via: " section.
  770. Under the TCP/IP heading at the bottom of the window, enter the host name or IP address in the "Connect to:" field, and the TCP port number in the "Port:" field.  Some FirstClass systems use port 3000, some use port 3004.
  771.  
  772. TCP/IP Caveats:
  773.      Because of the network overhead, TCP connections over a modem are slower than "straight" modem connections - so mail exchanges will run more slowly.  Worse, the already-slow FirstClass CLUI message editor gets even slower under a TCP/IP connection, so sending messages will be even slower than normal.
  774.  
  775. The FirstClass CLUI appears to have yet another bug - XModem-1K downloads refuse to work under a TCP/IP connection, so BulkRate steps down to a XModem-128 file transfer.  Uploads still work with 1K blocks.
  776.  
  777.  
  778. *BulkRate Help         Limitations                                  Limitations
  779.  
  780. 1931
  781. LIMITATIONS
  782.  
  783. Unlisted conferences
  784.      BulkRate cannot currently send new mail to unlisted conferences.  Unlisted conferences are conferences which you cannot post to from your mailbox.  Using the threaded reply feature, you can, however, reply to messages in unlisted conferences.
  785.  
  786. Styled text:
  787.      No font, sixe, style, or color information is available via the FirstClass CLUI, so BulkRate cannot support styled text. 
  788.  
  789. Extended characters:
  790.      The FirstClass CLUI apparently supports only 7-bit ASCII, so Macintosh extended characters (like: å∫ç∂´ƒ©˙ˆΔ˚¬µ˜øπœ®ß†¨√∑≈¥Ω¡™£¢∞§¶ªº–≠“‘…æ≤≥÷`«) are not reliably supported. This can cause problems when reading text that has these characters, especially "curly quotes", en and em dashes, and the like.  This problem is more important, however, in sending messages; if a user or conference has extended characters in its name, you may experience problems sending mail to that address.  Try abbreviating the name to work around this problem.
  791.      When sending a message, BulkRate will translate extended characters to standard ASCII.  This translation is controlled by STR# resource 5000.  You may edit this using ResEdit or a similar tool if you do not like the character translations I have chosen.  String 1 in the resource is the translation for character 128 (Ä), string 2 is the translation for character 129 (Å) and on to string 128, which is the translation for character 255.  To change the translation for character 180 (¥), you would edit string 53 (180 - 127 = 53) in STR# resource 5000.  Note that not all extended characters display the same in every font.
  792.  
  793.   
  794. SoftArc has indicated that they plan to eventually release a "Client Toolkit" or "Client API," which would eliminate many of the shortcomings of using the CLUI as BulkRate's interface with FirstClass.  A Client API should allow support for threaded messages and replies, styled text, and extended characters.
  795.  
  796. *BulkRate Help         Hints and tips                               Reading and editing during an exchange
  797.  
  798. 676
  799. HINTS AND TIPS
  800.  
  801. Reading and editing during an exchange
  802.      Unlike earlier versions of BulkRate, you can actually do other things while a mail exchange is taking place.  You can work in other open applications, or you can read mail from another BBS, or you can read mail as it comes in during an exchange.
  803.  
  804.      Try not to leave a dialog box or alert on the screen for too long while an exchange is in progress; they do not allow any processor time to be devoted to the exchange and certain actions can then timeout.  In most cases, BulkRate allows a full minute before timing out, so as long as the dialog box or alert is acted upon in less than a minute, you should be fine.
  805.  
  806. *BulkRate Help         Hints and tips                               Moving and renaming BulkRate files
  807.  
  808. 657
  809. MOVING FILES AROUND
  810.  
  811. BulkRate has to keep track of the location of a lot of files.  If you move or rename mailboxes or settings files, BulkRate may not be able to find them when running an exchange or script.  You can force BulkRate to update the location of mailboxes by using the "Mail settings..." dialog under the Service menu.  To update the location of Service files in a Script, you must delete the Service file from the Script list and re-add it.
  812. If you move an Address Book file, you'll need to re-open it in order for BulkRate to use it as the default address book file.  Otherwise BulkRate will continue to look in the OLD location for the file.
  813.  
  814.  
  815. *BulkRate Help         Hints and tips                               Adding a “signature” to your messages
  816.  
  817. 2455
  818. ADDING A “SIGNATURE” TO YOUR MESSAGES
  819.  
  820. BulkRate supports a “tagline” feature, in which a randomly chosen single line “tagline” is appended to the end of your message.  On the Internet, multi-line “signature” files are very popular ways to end newsgroup postings and e-mail.  You can have BulkRate automatically add a “signature” to the end of each outgoing message you send.  To do so, you must create one or more text files and place them in the same folder as the BulkRate application.
  821.  
  822. The file names must end in “.sig”.  When BulkRate sends a message, it first looks for a “.sig” file with the same name as the “Host name” of your Service file.  If you have a Host name of “LAMG BBS”, BulkRate will look for a file named “LAMG BBS.sig”.  If it doesn’t find a file with this name in the same folder as the BulkRate application, it then looks for a file named “BulkRate.sig”.  Failing that, it does not append any .sig text to your outgoing message.
  823.  
  824. Be sure that the filename of the signature file (if it isn't named “BulkRate.sig”) is the same as the Host name , not the service filename .  For example, if your service filename is “LAMG”, but the Host name (as it appears in the service window) is “LAMG BBS”, a signature file named “LAMG.sig” won't work, but a signature filename of “LAMG BBS.sig” will work.
  825.  
  826. Also note that a specific service signature file will be used in place of the BulkRate.sig file, not with it.
  827.  
  828. You can use any word processor or even TeachText to create your “.sig” files; just make sure that the file is saved in “TEXT” format.  Unfortunately, there is no easy way to create a .sig file from within BulkRate.
  829.  
  830. However, there is a way to create a .sig file from within BulkRate, though it will require a little extra editing on your part to do so.  Select ‘Compose new’ from the Message menu.  Ignore the message header info and just enter the text you want into the body of the message.  When you're satisfied with your signature, select ‘Save as text’ from the File menu and save the message with the .sig name you wish to give it.  The file will be saved as a SimpleText text file.  Once it is saved, click the close-box of the message window, and when prompted to save the message, click the Don't Save button so that the message will be eliminated from your outgoing mail.  Since the Save as text feature includes the message header, you'll have to edit the text file once it is saved to remove the header information.
  831.  
  832. *BulkRate Help         Registration                                 Registering BulkRate
  833.  
  834. 2152
  835. REGISTERING BULKRATE
  836.  
  837. BulkRate is shareware.  You may try BulkRate for free, and give copies of the unregistered application to your friends. I ask that all documentation be included if you pass it on to a friend or upload it to a BBS.
  838.  
  839. If you wish to continue using BulkRate, I ask that you pay the shareware fee.
  840. BulkRate has the following pricing:
  841.  
  842.        1-9 single user licenses, $25 per user
  843.        10-49 single user licenses, $20 per user
  844.        50+ single user licenses, $15 per user
  845.  
  846.        A Site License costs $1000 (roughly equal to 67 users) and covers all locations for your organization within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the software.
  847.        A World-Wide License costs $5000 and it covers all locations for your organization on the planet Earth.
  848.  
  849. Paying for BulkRate is fairly simple. Open the Register application that accompanies BulkRate. Enter your name, your email address, and the number of single user licenses you wish to purchase (or Site or Word-Wide licenses). Save or Copy or Print the data from the Register application and send the data and payment to Kagi Shareware.  Kagi Shareware handles my payment processing.
  850.  
  851. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you  can Save the data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number.
  852.  
  853. If paying with a credit card, you may also pay via the World-Wide-Web:
  854.  
  855.     <http://kagi.direct.net/cgi-bin/register1.cgi?IH>
  856.  
  857. Payments sent via email or WWW are processed within 3 to 4 days. You will receive an email acknowledgement when it is processed.
  858. Payments sent via fax take up to 10 days and if you provide a correct Internet email address you will receive an email acknowledgement.
  859.  
  860.  
  861. *BulkRate Help         Support                                      BulkRate support
  862.  
  863. 658
  864. Support and Updates
  865.  
  866. I am happy to help people with BulkRate.   I am very bad at answering snail mail and I don't usually like to be called at home, which is why I recommend that you ask me questions online.   
  867.  
  868. You may post questions in the BulkRate conference available on OneNet, or send me questions at my Internet e-mail addresses: 
  869.  
  870. greg_neagle@kagi.com
  871. greg_neagle@aol.com (I check this less often)
  872.  
  873. On America Online, my screen name is GregNeagle.
  874.  
  875. I maintain a WWW site, and an FTP site where you can get the latest info and download the current version of BulkRate:
  876.  
  877. http://members.aol.com/gregneagle/bulkrate/
  878. ftp://members.aol.com/gregneagle/pub/
  879.  
  880. *BulkRate Help         Credits                                      BulkRate credits and copyrights
  881.  
  882. 1041
  883. CREDITS
  884.  
  885. I'd like to thank the following people and organizations for their help and support:
  886.  
  887. my wife, Allison
  888. Scott Goldman
  889. Clinton S. Gilbert
  890. Paul Hampton
  891. Reed Hutchinson
  892. Pete Johnson
  893. Jerry Klorman
  894. Kevin Pfeiffer
  895. Horst Prillinger
  896. Dori Smith
  897. Bill Williams
  898. DigitalPopcorn Online Services
  899. Los Angeles Macintosh Group
  900. MacValley Users Group
  901.  
  902. and all beta testers and users of previous versions of BulkRate, for their comments and suggestions.
  903.  
  904. Macintosh™ is a trademark of Apple Computers, Inc.
  905. FirstClass® is a registered trademark of SoftArc, Inc.
  906. Portions of BulkRate are copyright ©  Staz Software, the rest is copyright © 1991-1996 Greg Neagle.
  907.  
  908. The next time you are in Southern California, call these fine FirstClass® BBSs:
  909.  
  910. DigitalPopcorn
  911. A FirstClass® BBS with Internet e-mail, Usenet newsgroups, and more.
  912. Administrator: Kevin Pfeiffer
  913. (818) 398-3303 Pasadena 
  914.  
  915. LAMG BBS
  916. The BBS of the Los Angeles Macintosh Group
  917. Administrator: Reed Hutchinson
  918. (310) 451 5264 Santa Monica
  919.  
  920. I can be reached as "Greg Neagle" on either of these BBSs.
  921.  
  922.  
  923.